home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / libscan.z / libscan
Encoding:
Text File  |  1998-10-30  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LLLLIIIIBBBBSSSSCCCCAAAANNNN((((3333))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        LLLLIIIIBBBBSSSSCCCCAAAANNNN((((3333))))
  5.  
  6.  
  7.  
  8. LLLLIIIIBBBBRRRRAAAARRRRYYYY DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  9.      _l_i_b_s_c_a_n provides a C Language application programming interface (API) for
  10.      scanners.  Application programs that use libscan can retrieve data from
  11.      any scanning device for which a corresponding scanner driver exists.
  12.  
  13. LLLLIIIIBBBBRRRRAAAARRRRYYYY AAAACCCCCCCCEEEESSSSSSSS
  14.      Programs that call _l_i_b_s_c_a_n functions must include the _s_t_d_i_o._h and
  15.      _s_c_a_n_n_e_r._h header files located in the /_u_s_r/_i_n_c_l_u_d_e directory.  In
  16.      addition, the programs must link with the _l_i_b_s_c_a_n._a and _l_i_b_m_p_c._a
  17.      libraries located in /_u_s_r/_l_i_b.
  18.  
  19. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  20.      IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn aaaabbbboooouuuutttt iiiinnnnssssttttaaaalllllllleeeedddd ssssccccaaaannnnnnnneeeerrrrssss
  21.                     SCSetScanEnt
  22.                     SCGetScanEnt
  23.                     SCEndScanEnt
  24.  
  25.      GGGGeeeettttttttiiiinnnngggg tttthhhheeee ddddeeeeffffaaaauuuulllltttt ssssccccaaaannnnnnnneeeerrrr nnnnaaaammmmeeee
  26.                     SCDefaultScannerName
  27.  
  28.      OOOOppppeeeennnniiiinnnngggg aaaa ssssccccaaaannnnnnnniiiinnnngggg ddddeeeevvvviiiicccceeee
  29.                     SCOpen
  30.                     SCOpenScreen
  31.                     SCOpenFile
  32.                     SCClose
  33.  
  34.      SSSSccccaaaannnnnnnneeeerrrr ssssppppeeeecccciiiiffffiiiicccc ooooppppttttiiiioooonnnnssss
  35.                     SCOptions
  36.                     SCHasOptions
  37.  
  38.      SSSSccccaaaannnnnnnneeeerrrr iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  39.                     SCScannerName
  40.                     SCGetMinMaxRes
  41.                     SCGetScannerRes
  42.                     SCGetPageSize
  43.                     SCGetDataTypes
  44.  
  45.      SSSSccccaaaannnnnnnniiiinnnngggg ssssttttaaaatttteeee
  46.                     SCSetup
  47.                     SCScan
  48.                     SCScanFD
  49.                     SCAbort
  50.                     SCGetStatus
  51.                     SCGetStatusFD
  52.                     SCGetSaveOptions
  53.                     SCSetSaveOptions
  54.  
  55.      SSSSccccaaaannnn ddddaaaattttaaaa      SCGetScanLine
  56.                     SCGetScanSize
  57.                     SCGetFD
  58.                     SCDataReady
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLIIIIBBBBSSSSCCCCAAAANNNN((((3333))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        LLLLIIIIBBBBSSSSCCCCAAAANNNN((((3333))))
  71.  
  72.  
  73.  
  74.      DDDDooooccccuuuummmmeeeennnntttt FFFFeeeeeeeeddddeeeerrrr
  75.                     SCFeederGetFlags
  76.                     SCFeederSetFlags
  77.                     SCFeederAdvance
  78.                     SCFeederReady
  79.  
  80.      EEEEvvvveeeennnnttttssss         SCGetEventFD
  81.                     SCEventPending
  82.                     SCGetEvent
  83.  
  84. SSSSIIIIGGGGNNNNAAAALLLL HHHHAAAANNNNDDDDLLLLIIIINNNNGGGG ((((SSSSIIIIGGGGCCCCLLLLDDDD))))
  85.      _l_i_b_s_c_a_n spawns child processes to execute scanner drivers and scanner
  86.      specific options programs.  Some _l_i_b_s_c_a_n functions terminate these child
  87.      processes; within these functions, SIGCLD is blocked and _l_i_b_s_c_a_n waits on
  88.      the children.
  89.  
  90.      It is possible that a scanner driver or a scanner specific options
  91.      program will terminate asynchronously.  Applications using _l_i_b_s_c_a_n should
  92.      be prepared to handle the SIGCLD signal.  _l_i_b_s_c_a_n uses the POSIX signal
  93.      handling and wait interfaces.
  94.  
  95. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.      scanners(1M), gscan(1), sigprocmask(2), sigaction(2), waitpid(2),
  97.      intro(3).
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.